home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / net / plip38src.lha / plip / plip.doc < prev    next >
Text File  |  1994-06-02  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. PLIP.DEVICE(1)                                     PLIP.DEVICE(1)
  5.  
  6.  
  7. NAME
  8.        PLIP - A Parallel Line IP SANA2 Device Driver
  9.  
  10. OVERVIEW
  11.        PLIP  is  a  network device driver conforming to the SANA2
  12.        standard.  It allows linking of  two  Amigas  using  their
  13.        parallel  ports.   Transfer  speed is around 40 kbyte/sec.
  14.        The complete low level transfer protocol is integrated  in
  15.        the  device driver, including port arbitration handshaking
  16.        and interrupt driven reads.  Although the transfer process
  17.        itself is cpu intensive, the device needs no cpu resources
  18.        when no transfer is in progress.
  19.  
  20.        PLIP is intended as a low-cost networking solution,  since
  21.        the  capabilities  of  the  parallel hardware are somewhat
  22.        limited.  However, it gives much better results than  SLIP
  23.        and leaves the serial port free.
  24.  
  25. REQUIREMENTS
  26.        You  will  need   at   least kickstart and workbench V2.04
  27.        (37.175)  to use PLIP. Also some SANA2 compliant  network-
  28.        ing  protocol (like Envoy, AS225R2 or AmiTCP) will come in
  29.        handy :-).
  30.  
  31. INSTALLATION
  32.        Just copy plip.device to devs:networks.  See the  documen-
  33.        tation of your networking package for further installation
  34.        steps.  If you are going to use both Envoy and AS225  over
  35.        PLIP  at the same time, be sure to first start Envoy, then
  36.        AS225.  If you've  got  problems  with  multiple  protocol
  37.        stacks  you  might  try making the packet and host IDs for
  38.        each protocol unique.
  39.  
  40.        Since PLIP only allows two hosts to  be  linked  together,
  41.        addressing   is   limited   to   1  Bit.   One  host  uses
  42.        plip.device, Unit 0, the other one  plip.device,  Unit  1.
  43.        The  device  will  not  work if both machines use the same
  44.        unit number.
  45.  
  46.        PLIP   looks   for   an   environment   variable    called
  47.        ENV:SANA2/PLIP.config. This should contain one line termi-
  48.        nated with a newline, which will  be  parsed  by  ReadArgs
  49.        according to the template
  50.  
  51.        TIMEOUT/K/N,PRIORITY=PRI/K/N,MTU/K/N,BPS/K/N,RETRIES/K/N
  52.                where
  53.  
  54.        TIMEOUT=num
  55.                Packet receive timeout, default is 330000.  Set to
  56.                a  higher  value  if  you  have problems with slow
  57.                machines.
  58.  
  59.        PRIORITY=num
  60.                PLIP task priority, default is 15. Do  not  change
  61.  
  62.  
  63.  
  64. Version 38.11               Release 4                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PLIP.DEVICE(1)                                     PLIP.DEVICE(1)
  71.  
  72.  
  73.                this.
  74.  
  75.        MTU=num Maximum  packet  data size, default and maximum is
  76.                8192. If you change this, be sure to change it  on
  77.                both machines to the same value!
  78.  
  79.        BPS=num The  nominal  bits per second rate returned from a
  80.                device query. Default is 25000 which is  much  too
  81.                low but works with beta Envoy.
  82.  
  83.        RETRIES=num
  84.                The  maximum  number of times, the driver tries to
  85.                resend a packet on  error.  Default  is  63  which
  86.                means a total of 64 tries.
  87.  
  88.        An example PLIP.config is included. All recognized parame-
  89.        ters will be printed into the startup window of  PLIP.  If
  90.        PLIP  does  not  run  or  shows problems transmitting data
  91.        first try deleting the PLIP.config file on  all  connected
  92.        machines,  so  PLIP  uses  the internal default values. If
  93.        that doesn't help, please contact us (see end of  documen-
  94.        tation).
  95.  
  96. CABLE
  97.        You  will  need  male  (A1000: female) DB25 connectors and
  98.        some (up to 4 meters) parallel cable. Connect:
  99.  
  100.             D0-D7/BUSY/POUT   to   D0-D7/BUSY/POUT
  101.             ACK               to   STROBE
  102.             STROBE            to   ACK
  103.             GND               to   GND
  104.  
  105.        You can look up the pin assignment in your Amiga User Man-
  106.        ual, appendix A.  Please note that this cable differs from
  107.        ParNet! Double check before using!
  108.  
  109.        There is a potential problem with the RI (ring  indicator)
  110.        line  on  the  serial  port.  If you have problems running
  111.        PLIP, first try to remove  any  device  connected  to  the
  112.        serial  port.  If that helps, you might try cutting the RI
  113.        line in the serial connector.
  114.  
  115. COPYRIGHT
  116.        Under no circumstances may PLIP be  used  on  any  machine
  117.        which is used for the research, development, construction,
  118.        testing or production of weapons or other military  appli-
  119.        cations.  This also includes any machine which is used for
  120.        training persons for any of the above mentioned  purposes.
  121.  
  122.        This  is  the  only restriction, in all other respects you
  123.        may do with PLIP what you want. Please  keep  us  informed
  124.        about any enhancements you make.
  125.  
  126.        Use PLIP at your own risk.  Please send bug reports to:
  127.  
  128.  
  129.  
  130. Version 38.11               Release 4                           2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PLIP.DEVICE(1)                                     PLIP.DEVICE(1)
  137.  
  138.  
  139.             o.wagner@aworld-2.aworld.de
  140.        or
  141.             m.balzer@aworld.aworld.de
  142.  
  143.        Please  exactly  state  the  machine  configuration  which
  144.        causes PLIP to fail.
  145.  
  146. HISTORY
  147.        V37.11
  148.         - small speedups in transmission handshaking
  149.         - now uses utility library for parsing the buffer
  150.           management taglist
  151.  
  152.        V37.14
  153.         - optimized BPS and MTU
  154.         - cleaned up the code
  155.  
  156.        V38.5
  157.         - fixed CRC check
  158.         - added information window
  159.         - some protocol fixes
  160.  
  161.        V38.7
  162.         - changed hardware type to 13 (official PLIP ID)
  163.         - added configuration mechanism
  164.  
  165.        V38.9
  166.         - some race conditions eliminated
  167.         - packet sequencing corrected
  168.         - added write retry mechanism (configurable)
  169.         - fixed possible AbortIO bug
  170.         - seems to work with Envoy 37.131, at least using
  171.           the default config...
  172.  
  173.        V38.10
  174.         - fixed bug with configuration during startup
  175.         - default MTU reduced to 1024 bytes
  176.  
  177.        V38.11
  178.         - added tracktype support (beta) in order to make
  179.           PLIP work in conjunction with AmiTCP
  180.         - removed autoinit for dos.library
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. Version 38.11               Release 4                           3
  197.  
  198.  
  199.